home *** CD-ROM | disk | FTP | other *** search
/ Hand Picked Software / Hand Picked Software.iso / com / qcom312 / qcom.doc < prev    next >
Text File  |  1995-03-13  |  47KB  |  1,037 lines
  1.  
  2.                                     
  3.    
  4.    
  5.    
  6.    
  7.    
  8.        QCOM.EXE   
  9.        Revision 3.12
  10.        Apr 1994
  11.    
  12.    
  13.        ------------------------------------------   
  14.    
  15.    
  16.    
  17.        Copyright 1990-1994 by RTFM Software and Richard W. Turenne
  18.        Winnipeg, Mb.  All Rights Reserved   
  19.    
  20.    
  21.    
  22.        All users are granted a limited license to try QCom for thirty  
  23.        day evaluation period to determine its' suitability.   
  24.    
  25.    
  26.        QCom is USER SUPPORTED.  It is not Public Domain and is not free.   
  27.        This means, if you decide to use this program, please show your   
  28.        support by registering it with the author.   
  29.    
  30.    
  31.        To add INCENTIVE, those who register will be shown how to utilize   
  32.        the user defineable functions.  Users can pre-define other   
  33.        external dos functions, or other external protocols, or batch files,  
  34.        and access them with a single keystroke.  Additionally, they will be  
  35.        able to eliminate the "nag" screen when QCom ends.   
  36.    
  37.    
  38.    
  39.    
  40.    
  41.        ------------------------------------------------------------------   
  42.    
  43.    
  44.    
  45.    
  46.    
  47.    
  48.    
  49.    
  50.    
  51.    
  52.    
  53.                                   -Page 1-    
  54.    
  55.   SYSTEM REQUIREMENTS:   
  56.    
  57.      Minimum of one floppy drive, 256K or more memory, and a modem of   
  58.      course.   
  59.    
  60.    
  61.   QCom Features:   
  62.    
  63.      + Compact and VERY EASY to use.
  64.      + Easy Modem Setup.
  65.      + Modem finder.
  66.      + Mouse support.
  67.      + User Defined Main menu.
  68.      + Configurable Com Port IRQ and address.
  69.      + Easy Scripting. No programming experience required.
  70.      + Extensive help.
  71.      + Auto-Script maker.
  72.      + FIFO (16550) UART support.
  73.      + Transfer Protocols including Ascii, Xmodem, Xmodem1k, Ymodem,
  74.        YmodemG, Zmodem and any externals.
  75.      + Terminal Emulation for TTY, ANSI, ANSI-BBS, VT100.
  76.      + Auto download/upload triggering for ZModem and CIS QuickB.
  77.      + AutoSend, AutoHangup Timers and AutoEnd.
  78.      + Dialing Directory size limited only by available conventional memory.
  79.      + 500 line Scroll Back Buffer with text quoter.
  80.      + File tagging for batch Uploads.
  81.      + QCom Mail Processor offline mail reader.
  82.      + Function key and Alt-Key Macros.
  83.    
  84.    
  85.    
  86.    
  87.    
  88.    
  89.    
  90.                                   -Page 2-    
  91.   FIRST TIME SETUP AND CONFIGURATION:   
  92.    
  93.     Run QCom.  QCom will execute the configuration utility, QComCFG.
  94.     If you're familiar with your communications hardware you can edit
  95.     the Com Port, modem string, etc in the Edit QCom.CFG screen.
  96.     
  97.     Press F1 to go to the pull-down Menus.
  98.     Selecting from the various menus you can set your Com Port, Modem type
  99.     and any other options you wish. To exit, select the File Menu,
  100.     Save your changes, then Exit. Qcom will continue where it left off.
  101.     
  102.     Wait a few moments while the modem is being initialized.   
  103.     An error message usually means the modem has not been properly   
  104.     initialized.  Correct modem initialization is critical to all   
  105.     operations that involve the modem.  If the string from QCom Setup   
  106.     is incorrect, please advise the author so that corrections can be   
  107.     made.  Refer to the Trouble Shooting section for solutions.
  108.  
  109.     Special Character codes in QCom.CFG:   
  110.     The "|" character will send a carriage return to the modem.  The   
  111.     "~" is a half-second pause to allow the modem time to execute the   
  112.     commands in the initialization string.  Some modems need more time   
  113.     than others.  The pause is executed by QCom and the modem will not   
  114.     actually receive the "~" character.   
  115.     Function key definitions are shown in the last ten lines.  You can   
  116.     configure your own "macros" here.  Control codes can be sent with   
  117.     the use of the "^" character.   
  118.     Example:           ^[ = an escape character   
  119.                        ^M = a carriage return   
  120.     Refer to any good ASCII chart for others.   
  121.                                   -Page 3-    
  122.   COMMANDLINE PARAMETERS:   
  123.    
  124.     In addition to specifying a script,  the user can specify an   
  125.     alternate configuration file and an alternate phone directory file.   
  126.     This allows network users to have CFG and FON files tailored to   
  127.     their individual needs.   
  128.    
  129.     Switches are:   
  130.            /S = load and execute script file   
  131.            /C = load alternate configuration file   
  132.            /P = load alternate phone directory   
  133.            /B = force monochrome  
  134.     Usage is: QCOM [/Sfilename.SCR] [/Cfilename.CFG] [/Pfilename.FON] [/B]  
  135.    
  136.     Users may use the options in any sequence.  The switches (/S,/C,/P)   
  137.     must NOT have a space preceding the filename.  When the commandline   
  138.     options are not used, QCom defaults to QCom.CFG and QCom.FON.   
  139.    
  140.   TERMINAL EMULATION:   
  141.    
  142.     This version has built-in support for ANSI-BBS and straight TTY.   
  143.     Pressing ALT-K will toggle between the two.   
  144.    
  145.   STATUS LINE EXPLANATION:   
  146.    
  147.     ----------------------------------------------------------------------   
  148.     Alt-Z:Help SEC  Host system name     Online 05:55:55 Z COM1:2400N8   
  149.     ----------------------------------------------------------------------   
  150.         |       ||||         |                |       |     |       |   
  151.         |       ||||         |                |       |     |       |   
  152.     Commands    ||||         |                |       |     |       |   
  153.     Script on -- |||         |                |       |     |       |   
  154.     Echo On ----- ||         |                |       |     |       |   
  155.     Capture On --- |         |                |       |     |       |   
  156.     Alarm Off -----          |                |       |     |       |   
  157.     Host name ---------------                 |       |     |       |   
  158.     Carrier status ---------------------------        |     |       |   
  159.     Time connected -----------------------------------      |       |   
  160.     Transfer protocol --------------------------------------        |   
  161.     Communication port, baud, parity and databits ------------------   
  162.    
  163.    
  164.    
  165.    
  166.    
  167.    
  168.    
  169.    
  170.    
  171.    
  172.    
  173.                                   -Page 4-    
  174.   FILE TRANSFER PROTOCOLS:   
  175.    
  176.     Transfer protocols are used as a method of flow-control and error
  177.     checking when transferring files.  These protocols are specified when 
  178.     adding to the Dialing Directory.  The Dialing Directory is displayed 
  179.     when you press ALT-D. The use of ZModem protocol is recommended if 
  180.     the host computer has the option available.   
  181.     QCom will default to using the built-in protocol unless an external 
  182.     protocol is otherwise specified when editing the Dialing Directory
  183.     or when doing a file transfer.
  184.  
  185.     ZModem options:
  186.      -r  receive a file.  This switch must come last. 
  187.      -s  send a file.   This must be the last switch. 
  188.      -p  Send or accept complete pathnames. 
  189.      -l####  Specify a locked baud rate. 
  190.      -h  hardware  flow control  (RTS/CTS). 
  191.      -i  ignore absence of carrier detect signal.  
  192.      -v  disable serial I/O  during disk writes. 
  193.      -e# file exists option.     
  194.            -e0   -- do not download. 
  195.            -e1  Resume at the end of current file (default). 
  196.            -e2  Download the file as a separate file. 
  197.            -e3  Overwrite the existing file. 
  198.      -w####  transmit window size (must be a multiple of 128). 
  199.      -x  Escape all  control characters. 
  200.      -x# Escape specific control characters  
  201.      -6  Force use of 16 bit CRC.  
  202.      -y  overrides received filename 
  203.      16550 related switches: 
  204.      -d  Do not  enable 16550  FIFO   mode.  
  205.      -t# characters per interrupt (range 1 to 16).  
  206.      -m  Disable modem status register interrupts.  
  207.   
  208.   EXTERNAL PROTOCOLS:   
  209.     QCom can be set up to use external protocols.  In QCom Configuration
  210.     select the XFer Options under the Protocols Menu. From the Pop-up
  211.     list of protocols you can select and edit existing protocol options,
  212.     or add a new one by selecting an unused entry marked with " ******* ". 
  213.     Options for the protocols supplied with QCom need not be modified.
  214.     Options for the DSZ examples can be modified to suit your requirements
  215.     but remember that QCom automatically sends the port number, baud
  216.     rate and appropriate pathname to these choices.
  217.     For other external protocols, options such as port, baud rate
  218.     and pathnames will have to manually entered where required.
  219.     Registered users are shown a shortcut way to pass these parameters
  220.     making it unnecessary to edit them whenever a baud rate or pathname
  221.     changes.    
  222.     Note: An unregistered copy of QCom is not "crippled".  The instruct-   
  223.     ions for this feature of QCom are provided to all those who register.   
  224.  
  225.                                 -Page 5-
  226.  
  227.   VARIOUS FUNCTIONS:   
  228.    
  229.     ALT-A:   
  230.          Toggles the sound functions on or off.   
  231.     ALT-B:   
  232.          Allows the user to scroll back up to 500 lines of received data.   
  233.          Search capabilities are provided for finding particular text and   
  234.          the whole buffer can be written to disk using the Save command,   
  235.          "S" (the filename defaults to "QComBuff.Txt") or erase the buffer   
  236.          with "E". "Q" is for quoting previously received text. When "Q" is  
  237.          pressed another menu of choices is presented and one line of text   
  238.          will be highlighted. This highlighted line can be moved through   
  239.          the buffer with the cursor keys, Home, End, PgUp, or PgDn.  Lines   
  240.          can be tagged or untagged by pressing "T" or the SPACE bar.  Once   
  241.          text is selected, it can be save to disk with "F" or immediately   
  242.          sent to the host with "S".  This last feature allows you to quote   
  243.          lines from a message and return them to the host's editor when   
  244.          answering that message online.  "U" will untag all tagged lines   
  245.          as will sending or filing.   
  246.     ALT-C:   
  247.          Communication parameters can be modified here.  These changes   
  248.          are in effect until changed again or until QCom ends.   
  249.          Com Port must be set in QCOm.CFG. Port changes will not take   
  250.          effect unless QCom is restarted.   
  251.    
  252.    
  253.                                   -Page 6-    
  254.   VARIOUS FUNCTION CONTINUED...   
  255.    
  256.     ALT-D:   
  257.          Displays the dialing directory.  Use the arrow keys to select   
  258.          a number and ENTER to dial that number.  Other keys that are   
  259.          PGUP, PGDN, HOME and END.  HOT TIP: Pressing ALT and a letter   
  260.          will put the cursor on the first line beginning with that   
  261.          letter.   
  262.          Add a new entry with "A" or edit an existing one with "E".  To   
  263.          delete an entry press "D".  You can dial the phone with a   
  264.          manually entered number using "M".   
  265.          Phone entries can be tagged or untagged with the Space bar.   
  266.          This will cause QCom to continuously dial all tagged numbers   
  267.          until a connection is made.  Dialing of tagged numbers will   
  268.          commence when the Enter key is pressed.  Once a connection is   
  269.          made and broken you will be returned to the Dialing Directory.   
  270.          Continuous dialing will resume where it left off if Enter is   
  271.          pressed again.   
  272.     ALT-E:   
  273.          Toggles local echo on or off.  This is used when the host does   
  274.          not echo back the characters that you enter.  An "E" is   
  275.          displayed in the left-hand box on the status line when local   
  276.          echo is on.   
  277.     ALT-F:  
  278.          Toggles adding linefeeds to incoming and outgoing lines.  
  279.     ALT-G:   
  280.          Toggles output to printer on and off.  Allows all incoming text to  
  281.          be sent to the printer.  Make sure the printer is online.   
  282.     ALT-H:   
  283.          Sends the hang-up string to the modem and toggles DTR.   
  284.     ALT-I:   
  285.          Will save the current screen image to a text file as specified   
  286.          in the QCom.CFG file.  Default filename is QCOM.SCN which can   
  287.          be changed by editing the QCom.CFG file (use ALT-O).   
  288.     ALT-J:   
  289.          Allows shelling out to DOS without ending QCOM.  External   
  290.          programs can be executed while on-line.  The user could make   
  291.          use of other external file transfer protocols here if desired.   
  292.          Though there is a better way.  See registration section.   
  293.     ALT-K:   
  294.          Toggles between ANSI and TTY terminal emulation.   
  295.     ALT-L:   
  296.          Toggles the "capture" function.  If on, all incoming text will   
  297.          be saved in a file named as specified in the QCom.CFG file.   
  298.          Default is QCOM.CAP.  IF the file  does not exist in the   
  299.          default directory, it will be created.  Otherwise data is   
  300.          appended to an existing capture file.  A "C" is displayed in   
  301.          the left-hand box on the status line when capture is on.   
  302.     ALT-M:   
  303.          Sends the modem initialization string to the modem.  This   
  304.          string is automatically sent upon start-up (providing no   
  305.          carrier is present).   
  306.                                   -Page 7-    
  307.  VARIOUS FUNCTIONS Continued...   
  308.    
  309.     ALT-N:   
  310.          Split-screen separates incoming and outgoing keystrokes   
  311.          during a "chat" session.   
  312.     ALT-O:   
  313.          Brings up the QCOM.CFG file to the screen for editing.   
  314.          Press F10 to save the file and to set the Communication   
  315.          parameters as shown in the file.  Esc exits and makes no   
  316.          changes.   
  317.          If it were necessary to change baud or any other Communication   
  318.          parameter while online, use ALT-O to edit and F10 to set   
  319.          parameters.  Changing the port specified here will have no   
  320.          effect unless QCom is  restarted.   
  321.     ALT-P:   
  322.          Sends the current password from an entry of the Dialing   
  323.          directory when you have dialed and connected to that entry.   
  324.     ALT-Q:   
  325.          Load and execute a script.   
  326.     ALT-R:   
  327.          Re-dials the last phone number dialed when no entries are   
  328.          "Tagged", or if entries are "Tagged", it will continue dialing   
  329.          those.   
  330.     ALT-S:   
  331.          Toggles the Script Save function.  See the Script section for   
  332.          more information on making and using scripts.   
  333.     ALT-T:   
  334.          Allows changing of the transfer protocol currently in effect.   
  335.          This can be done while on-line.   
  336.     ALT-V:   
  337.          Allows the use of an external editor or file viewer.  The   
  338.          editor (or file viewer) of choice is defined in the   
  339.          configuration file.   
  340.     ALT-U:   
  341.          Will send a pure ascii text file to the host with no error-   
  342.          checking.  Ascii transfer is used to send a text file to the   
  343.          host PC.  For example, you might use it when sending a message   
  344.          to an electronic mail service.  Instead of editing the message   
  345.          on-line, you can prepare your message in advance.  Once on-   
  346.          line, go into the message editing screen on the host and then   
  347.          use ALT-U to upload your file.   
  348.     ALT-W:   
  349.          Wipes the screen clear.   
  350.     ALT-X:   
  351.          Ends QCOM.   
  352.    
  353.    
  354.                                   -Page 8-    
  355.   VARIOUS FUNCTIONS Continued...   
  356.    
  357.     ALT-Y:   
  358.         QCom becomes the host computer.  It will wait for any incoming   
  359.         phone calls until ESC is pressed.  When a call is received, QCom   
  360.         will answer the phone.  QCom sends the file HELLO.HOS 
  361.          to the caller's PC.  You can edit this file to suit your own   
  362.          needs using an ANSI "editor" like TheDraw.   
  363.          After this message file is sent, the caller is shown the   
  364.          menu contained in the file "MENU.HOS" 
  365.     
  366.          The caller can select one of the choices or the Host can enter   
  367.          selections.   
  368.          "Help"  sends a brief help screen, HELP.HOS to the user.   
  369.          "Area"  allows the user to change to a different subdirectory.   
  370.          When a caller selects the Area command, a file called AREAS.HOS   
  371.          is displayed on the caller's screen.  This is intended to show   
  372.          which "areas" (subdirectories in fact) the caller can have access    
  373.          to. A sample AREAS.HOS file is included.  Users will want to edit  
  374.          this file to suit their systems.  
  375.          "Files" allows the user to list specified files in that   
  376.          subdirctory.   
  377.          "Chat"  will allow  a dialogue between each PC.  To end Chat   
  378.          and return to the menu, the Host must press ESC.   
  379.          "Upload"  will send a file to the Host using DSZ ZModem.   
  380.          "Download" will send a file to the caller in a similar manner.   
  381.          If the caller specifies the correct path and filename, he will   
  382.          be able  to download a file from anywhere on the Host system.   
  383.          "Proto" will allow the caller to select XModem, YModem or   
  384.          ZModem protocols when transferring files.   
  385.          "Goodbye" will send BYE.HOS and terminate the connection .   
  386.          As Host, you can also terminate the call by pressing ALT-H to   
  387.          hangup. QCom will then wait for the next caller.  ALT-X will   
  388.          also terminate the call and in addition, end QCom.   
  389.          A local Host mode test is available: Press ENTER when waiting   
  390.          for incoming calls.  This allows preparation and preview  of   
  391.          your own host welcome messages or help screens.   
  392.    
  393.      PGUP:   
  394.          Uploads (sends) a file to the other system.  You will be   
  395.          prompted to enter a filename to upload.  The file can be   
  396.          preceded by a path only if NO upload path is specified in   
  397.          QCOM.CFG.  If the host supports batch uploads then you can   
  398.          take advantage of DSZ's capabilities; when prompted for a file   
  399.          to upload enter the name of a file containing a list of the   
  400.          files you wish to upload.  Precede the filename with an "@" .   
  401.          Example: "@files.lst".  Or you can use QCom to create a list   
  402.          file for you.  When prompted for a file to upload press ENTER   
  403.          with any global file specification (*.* or *.zip). You will   
  404.  
  405.  
  406.                                   -Page 9-  
  407.   
  408.  
  409.   VARIOUS FUNCTIONS CONTINUED...    
  410.          be shown a box containing filenames based on that specification.   
  411.          From here simply use the cursor keys to select a files and Mark   
  412.          them with "M".  When finished marking press ENTER and QCom will   
  413.          create "Files.LST" and pass that to DSZ for you.   
  414.    
  415.      PGDN:   
  416.          Downloads (receives) a file from the host computer.  If XModem   
  417.          or YModem are the protocols in effect, you'll be prompted to   
  418.          enter the filename to receive.  QCom tries to guess the   
  419.          filename based on recently entered text and places its' guess   
  420.          at the prompt.   
  421.          If ZModem is in effect, entry of filenames is not required and   
  422.          in fact, pressing PGDN is not required because QCom will call   
  423.          DSZ automatically when it receives the Zmodem Receive string.   
  424.      ALT-=:   
  425.          Toggles "Doorway" mode.  This removes the status line when in   
  426.          Doorway mode and gives full screen display for using remote   
  427.          applications.   
  428.          Allows you to make full use of all keys while online.  All   
  429.          Alt-key combinations except ALT-= are sent out and their usual   
  430.          functions are disabled in this mode.   For example, PgUp,   
  431.          PgDn, Home, End and the cursor key codes are transmitted.  You   
  432.          might make use of this when using a full-screen editor while   
  433.          online or when using your PC as a dumb terminal on a non-DOS   
  434.          system such as Unix.  Status line and all key functions are   
  435.          restored when Doorway mode is turned off.   
  436.      ALT-Minus:   
  437.          Enables/disables debugging during script execution.  Status   
  438.          line displays the next line of text which QCom is looking for.   
  439.      ALT-Space:
  440.           Enables the user defined Main menu when at the terminal screen.     
  441.      Ctrl-END   
  442.          Sends Break signal to host.  Used for terminating some mainframe   
  443.          connections.   
  444.      F1-F10:   
  445.          Sends the text as listed in the last ten lines of QCom.CFG.   
  446.          You can put your name, password, special key codes or whatever   
  447.          you wish here. 80 characters max on each line.   
  448.      Ctrl-F1   
  449.          Displays the "Function Key Macros" as they appear in QCom.CFG.   
  450.      Ctrl-F2   
  451.          Displays the "Alt Key Macros" for registered users.   
  452.    
  453.    
  454.    
  455.    
  456.    
  457.    
  458.    
  459.    
  460.    
  461.                                   -Page 10-    
  462.    SCRIPTS:   
  463.        Scripts are used for automating repetitive tasks such as dialing,   
  464.        logging in to an online service, and transferring files or     
  465.        electronic mail.  A script is generally made up of a series of    
  466.        commands for QCom to execute at the appropriate time.  The script    
  467.        can tell QCom to send text to the host or it can make QCom execute    
  468.        one of its' internal functions.   
  469.    
  470.    MAKING A SCRIPT:   
  471.       QCom has a built-in Script-save feature to simplify the creation of   
  472.       scripts. To create a typical login script you would do the    
  473.       following:   
  474.       1.  From the Dialing Directory dial the number.   
  475.       2.  When the host answers and immediately after the Dialing box   
  476.           clears, press Alt-S to start the script saver.  It will prompt    
  477.           you to enter the name of your script.  If, for example, you're    
  478.           calling CompuServe, you could name it CIS.SCR.   
  479.       3.  QCom will save each line of incoming text which prompts you for   
  480.           input.  For example the host may prompt you...   
  481.                    ENTER YOUR FULL NAME :   
  482.           To which you respond by typing in your name and pressing ENTER   
  483.           when the name is complete.  Always type entries in, don't use   
  484.           Function key macros when saving a script. If/when prompted to   
  485.           press "ANY" key always press ENTER.  QCom will store the host's   
  486.           prompt, and the text you have entered in the script.   
  487.           (Also Note: BBS software that has "HotKey" menu choices where    
  488.           the user is not required to press ENTER after selecting a letter    
  489.           is great BUT... when it comes to saving a script QCom will NOT    
  490.           save the line unless you press ENTER.  So when saving a script    
  491.           turn off the Hotkey feature at the BBS end.)   
  492.       4.  QCom will also store any commands you give it such as ALT-L   
  493.           to turn on the capture function.   
  494.       5.  When you wish to stop saving a script press Alt-S again.   
  495.       6.  To have this new script execute when you call this number again,   
  496.           add the name of your script into that entry in the Dialing   
  497.           Directory. The next time you dial that number the script will be   
  498.           loaded and executed.   
  499.    
  500.       Sample script :   
  501.       put a message on screen   
  502.       ;ECHO ^M This is the start of my script! ^M   
  503.    
  504.       let's capture the session to file.txt   
  505.       ;a-L file.txt   
  506.    
  507.       Do you want graphics (Enter)=no;^M   
  508.       What is your full name?;John Doe^M   
  509.    
  510.       sends password from the Directory entry we just dialed   
  511.       Password (Dots will echo)?;a-P   
  512.       Scan Message Base Since 'Last Read' (Enter)=yes;^M   
  513.       Press (Enter) to continue;^M   
  514.                                   -Page 11-    
  515.    
  516.    MAKING A SCRIPT Continued...   
  517.    
  518.       receiving (downloading) a file   
  519.       min. left) Main Board Command?;d^M   
  520.       Filename to Download (Enter)=none?;file.arc^M   
  521.    
  522.       downloads "file.arc"   
  523.       ;D/L file.arc   
  524.       Press (Enter) to continue;^M   
  525.    
  526.       goodbye   
  527.       min. left) Main Board Command?;g^M   
  528.    
  529.       give hangup command   
  530.       ;a-H Y   
  531.    
  532.       execute another script   
  533.       ;a-Q MyBBS.SCR   
  534.    
  535.       The following is an example of a script that connects to   
  536.       CompuServe through the DataPac network.   
  537.    
  538.       ;ECHO  Logging in to CompuServe.  Please wait...   
  539.    
  540.       send "..." when connected   
  541.       ;...^M   
  542.    
  543.       send node id number when the word DATAPAC is received   
  544.       DATAPAC;P 12345678^M   
  545.    
  546.       CompuServe Information Service   
  547.       Host Name:;CIS^M   
  548.    
  549.       insert your user ID   
  550.       User ID:;12345,6789^M   
  551.    
  552.       send password from dialing directory   
  553.       Password:;a-P   
  554.    
  555.       check for mail or whatever   
  556.       Enter choice!;5^M   
  557.       etc, etc.   
  558.    
  559.       See the included file QCOM.SCR for more examples on scripting.   
  560.    
  561.       Note: When saving a script, QCom saves every line of incoming text on   
  562.       which the user is prompted for input AND which is terminated with a   
  563.       carriage return ( by pressing the ENTER key).  Any line that prompts   
  564.       the user and does not require the ENTER key to be pressed, will NOT   
  565.       be saved in the script.  Such lines would have to be manually typed   
  566.       into the script with a text editor.   
  567.                                   -Page 12-    
  568.    MAKING A SCRIPT Continued...   
  569.    
  570.       In order to use a script automatically, put the name of the   
  571.       script file in the SCRIPT column in the Dialing Directory.   
  572.       One way to create a new script is to capture a session and then   
  573.       edit it to conform to the above format, using the semicolons to   
  574.       separate incoming and outgoing text.  Any unnecessary text can be   
  575.       deleted from the capture file (such as news bulletins, etc.).   
  576.       Rename the file using ".SCR" as the extension in your script   
  577.       filename.   
  578.    
  579.    COMMANDLINE SCRIPTS:   
  580.    
  581.       Commandline scripts allow you to start Qcom, dial a number, transfer   
  582.       files, hangup and end Qcom automatically.   
  583.    
  584.       To create such a COMMANDLINE script, run Qcom, press ALT-S before   
  585.       going into the Dialing Directory .  Enter the name of your script,    
  586.       and proceed to step the program through the whole dialing and    
  587.       connection procedure.  Qcom will save your commands as well as the    
  588.       text coming in and going out.   
  589.    
  590.       To execute this script from the commandline use:   
  591.    
  592.       "QCom /SMyScript.scr"   
  593.    
  594.       The "/S" tells QCom that the following is the name of a script to   
  595.       execute. You must use the full script filename.   
  596.       When a script is executing you will see an upper case "S" on the   
  597.       Status line.  To stop script execution at any time, press ALT-S.   
  598.    
  599.       Note:   
  600.       When your script dials a directory entry that has another script   
  601.       specified, the second script will be ignored.  You can, however,   
  602.       call another script by using the ALT-Q command.   
  603.       (eg. ";a-Q ANOTHER.SCR").   
  604.    
  605.    SCRIPT COMMANDS:   
  606.    
  607.       Most Script commands consist of shorthand for the keystrokes   
  608.       you would use when manually running QCom.  The ALT-Key commands   
  609.       that QCom understands can be entered into a script with  ";a-"   
  610.       followed by the letter you wish to use. Eg. ALT-P would be ";a-p".   
  611.       Upper or lower case will work.   
  612.    
  613.       Exceptions: ALT-- (ALT-Minus) and ALT-= cannot be saved or executed   
  614.       in a script.   
  615.    
  616.    
  617.    
  618.    
  619.    
  620.                                   -Page 13-    
  621.    SCRIPT COMMANDS CONTINUED...   
  622.    
  623.       The following are script commands that may be manually added to   
  624.       scripts.  These are NOT included in Saved scripts.   
  625.    
  626.       "ANY"     - used to send a given response to text that is received   
  627.                 repeatedly.   
  628.                 eg. ;ANY Press any key;^M   Whenever "Press any key" is   
  629.                 received, a carriage return will be sent. This will remain   
  630.                 in effect until the ANY command is used again in the script   
  631.                 to specify new incoming text.   
  632.                 eg. ANY   
  633.                 This effectively "turns off" a previous ANY command. QCom   
  634.                 will no longer respond to the previously specified incoming   
  635.                 text.   
  636.    
  637.      "DEBUG ON" -used in script debugging   
  638.                 The Status line shows which line of incoming text the    
  639.                 script is waiting for. This allows you to compare a script    
  640.                 line to actual received text to check for spelling errors    
  641.                 or typos in cases where a script is not working properly.   
  642.                 Pressing ALT-V during a debug session will load your script   
  643.                 into your editor so you can make corrections on the fly.   
  644.    
  645.      "DEBUG OFF" -disables the debug function.   
  646.    
  647.      "ECHO"     -prints text on the local screen.   
  648.                 eg. ";ECHO Please wait. Auto Logon in progress..."   
  649.                 Text can be colorized and positioned on screen   
  650.                 using ANSI escape codes.   
  651.    
  652.      "LOG"      - will save date, hostname, start time and duration   
  653.                 of calls in optional specified filename. If no log file   
  654.                 is specified, QCom defaults to "USAGE.LOG".   
  655.                 eg. ";LOG CIS.LOG"  could store a log of calls to   
  656.                 CompuServe. Also provided is a utility to total the   
  657.                 durations of calls, named QTT.EXE. Usage: QTT LogFile.   
  658.    
  659.      "WAIT"     - will pause the execution of a script for a specified   
  660.                 number of seconds.  Eg. ";WAIT 5"  will pause everything   
  661.                 for five seconds.  Do not pause for too long if you expect   
  662.                 to have incoming data during this time.  Hitting any key   
  663.                 will terminate a pause and continue the script.   
  664.    
  665.      "DOS"      Allows you to shell to Dos and execute batch files or   
  666.                 whatever.  Use the /WAIT switch after the commandline if   
  667.                 you wish to pause the display before returning to QCom.   
  668.                 eg:   
  669.                 ;DOS vampire.bat /WAIT   
  670.    
  671.    
  672.    
  673.                                   -Page 14-   
  674.   SCRIPT COMMANDS CONTINUED...   
  675.    
  676.       "ASK"     Used to get user input from the keyboard.  This will display  
  677.                 your "User Prompt" in a box and wait for user input.  When    
  678.                 the user presses Enter, QCom will compare the user's input    
  679.                 to the text in "Answer". If it is the same then the script    
  680.                 will go to the "Label". Otherwise the script will continue    
  681.                 with the next line. Use commas to separate the prompt,    
  682.                 answer and label.    
  683.                 Usage: ;ASK User Prompt ,Answer,Label    
  684.                 eg:   
  685.                 ;ASK Download your mail? (Y/N) ,Y,DownLoad Mail   
  686.                 ;GOTO No Download   
  687.                 :DownLoad Mail   
  688.                 ;...   
  689.    
  690.       "GOTO"    To branch to another part of the script.   
  691.                 eg:   
  692.                 ;GOTO Label 1   
  693.                 or...   
  694.                 When this text is received;GOTO Label 2   
  695.    
  696.       "CALL"    To go to another part of the script and execute until the    
  697.                 RET (Return) command is encountered. It returns to the line   
  698.                 following the Call. Calls can be nested 255 levels.   
  699.                 eg:   
  700.                 When this text is received;CALL Label 3   
  701.                 or...   
  702.                 ;Call Label 3   
  703.                 ;END   
  704.                 :Label 3   
  705.                 Look for this text;send something^M   
  706.                 ;RET   
  707.    
  708.       "RET"     As above, used to return from a CALL. A RET must not be    
  709.                 executed unless a CALL has been executed first. RET cannot    
  710.                 be used with GOTO.   
  711.                 Usage: ;RET   
  712.    
  713.       "T/O"     Timeout for incoming text.  A given timeout value will apply  
  714.                 to any script line waiting for incoming text which follows    
  715.                 the T/O command.    
  716.                 To enable timeout use: ;T/O Seconds   
  717.                 To disable timeout use: ;T/O 0   
  718.       
  719.         Example:   
  720.                 ;T/O 10   
  721.                 Wait for text for 10 seconds;Send if received before 10 secs  
  722.                 Otherwise wait for this for 10 seconds;...etc.   
  723.                 Disable timeout:   
  724.                 ;T/O 0    
  725.                                   -Page 15-      
  726.   SCRIPT COMMANDS CONTINUED...   
  727.        
  728.       "ENQ"     Have QCom do something upon receiving an ENQ character (^E).  
  729.       A typical use would be when transferring a file on Compuserve using   
  730.       the QuickB protocol. The following example shows how to have QCom   
  731.       shell out to OZBext (an external QuickB protocol) to transfer a file   
  732.       on Com port 2 when the ENQ character is received.   
  733.       Eg:  ENQ;DOS OZBext /c2 /x    
  734.    
  735.       Registered users may use port and file abbreviations, etc., where    
  736.       appropriate, as per their instruction sheet.   
  737.       After QCom receives this ENQ it stops looking for further ENQ's.   
  738.        
  739.       "END"    Used to stop script execution.   
  740.             eg:   
  741.             ;END   
  742.             or...   
  743.             When this text is received;END    
  744.  
  745.       "TAG" Used for tagging or marking Dialing Directory entries for 
  746.             dialing.
  747.             eg:
  748.             ;TAG PCUG 
  749.             QCom will tag or mark all Dialing Directory entries starting with  
  750.             "PCUG". To tag only one of several entries with similar names it is 
  751.             necessary to have something unique in the name you wish to tag.
  752.             eg: ";TAG PCUG Node 1"
  753.  
  754.             Note : When entries have been tagged with the above TAG command,   
  755.             use the DIAL command without a specified name.
  756.             eg:
  757.             ;TAG PCUG
  758.             ;DIAL
  759.             This will cause QCom to dial all tagged entries until a connection 
  760.             is made.
  761.     
  762.        "UNTAG" QCom will untag all marked Dialing entries.
  763.             eg:
  764.             ;UNTAG
  765.   
  766.       The following are script commands that may be manually added to   
  767.       scripts.  These ARE included in Saved scripts.   
  768.    
  769.       "DIAL"    -dials the entry specified. Eg. ";DIAL CompuServe"   
  770.       "U/L"     -uploads the specified file Eg. ";U/L Myfile.Zip"   
  771.       "D/L"     -downloads the specified file Eg. ";D/L Myfile.Zip"   
  772.       "BREAK"   -sends a BREAK signal to the host Eg. ";BREAK"   
  773.  
  774.  
  775.  
  776.  
  777.  
  778.                                    -Page 16-
  779.    
  780.    Labels:   
  781.       Like labels in batch files, a label is preceded by a colon and can   
  782.       consist of one or more words or numbers.  No semi colon is used as   
  783.       in other script lines.   
  784.       eg:   
  785.       :Label 1   
  786.       :Label 2   
  787.    
  788.    SEMICOLONS:       
  789.       In a QCom script, the semicolon is all important. It divides each   
  790.       line into incoming and outgoing text. Lines beginning with a semi-   
  791.       colon are commands that QCom will execute (such as an ALT-Key   
  792.       command).   
  793.       Also note that only the first semicolon is used as a divider.   
  794.       Subsequent semicolons are treated as regular text.   
  795.    
  796.       Any line of text in a script with no semicolon or colon is ignored    
  797.       by QCom and can be used as a comment line for clarification when    
  798.       viewing or editing the script.   
  799.    
  800.       Script execution takes place only in the terminal screen. If your   
  801.       script executes something like ALT-B (ScrollBack) or ALT-Z (Help),   
  802.       manual input will be necessary to return to the terminal screen to   
  803.       continue script execution.   
  804.    
  805.     FINAL NOTE ON SCRIPTS:   
  806.       When saving a script, incoming phone noise may be saved during a   
  807.       session and will have to be edited out before using the script.   
  808.       It's wise to double-check a newly created script for any unwanted   
  809.       characters.  Any pure text editor can be used to edit or create a   
  810.       script file.   
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.                                    -Page 17-
  825.    
  826.     TROUBLE SHOOTING:   
  827.       Symptom: Modem returns "ERROR" when initializing.
  828.       This simply means that one or more commands in the modem initialzation    
  829.       string is not understood by the modem. The modem initialzation string is  
  830.       stored in QCom's configuration file call QCom.CFG. You can view and edit  
  831.       this string if you wish. Press ALT-O to enter the Options screen where
  832.       you will find the modem Init string.
  833.       Refer to your modem instruction manual to compare the modem commands 
  834.       against thoise contained in the initialization string and delete those
  835.       that your modem doesn't understand. Save and exit with F10.
  836.       To test the string press ALT-M to reinitialize the modem.   
  837.    
  838.       Symptom:  "Cannot initialize Com Port x" error message. (x = 1 to 4)   
  839.       Meaning of error message: Qcom cannot find the Com Port that is   
  840.       specified in the configuration file (QCom.CFG).   
  841.       Possible causes:   
  842.       1. Error in configuration file.  The number specified there does not   
  843.          match the Com Port used by the modem.   
  844.       2. Hardware problem.  Two or more devices are configured for the same   
  845.          Com port or the Com port specified is not installed.   
  846.          Check that there is no conflict in hardware interrupt settings.   
  847.          If two serial devices attempt to use the same Interrupt (IRQ)   
  848.          setting chances are, neither will work. Typical settings would be:   
  849.    
  850.                            Com1 using IRQ 4, at I/O 3F8h   
  851.                            Com2 using IRQ 3, at I/O 2F8h   
  852.                            Com3 using IRQ 4, at I/O 3E8h   
  853.                            Com4 using IRQ 3, at I/O 2E8h   
  854.    
  855.       3. Software conflict. A memory resident program that ties up the Com   
  856.          port has been previously executed and has not been deinstalled.   
  857.          Carbon Copy is an example of such a program.   
  858.    
  859.       Symptom: "Modem not responding"   
  860.       Meaning of message: Modem did not respond with "OK" within the   
  861.       alotted time.   
  862.       Possible causes:  See the following:   
  863.    
  864.       Symptom: Modem does not dial out.  Modem does not receive some/all   
  865.       commands sent by QCom.   
  866.       Possible causes:   
  867.       1. Baud rate specified in the configuration file is too high for the   
  868.          modem. Set the default baud rate to your modem's fastest speed.  Modem 
  869.          will send back an "OK" when you initialize the modem (Alt-M) if   
  870.          all is well.   
  871.       2. External modem is not powered up or not connected properly.   
  872.       3. Possible hardware conflicts with another installed serial device.   
  873.          Internal modem has been improperly installed or configured.   
  874.       4. Modem initialization or dialing prefix strings are incorrect.          
  875.          Refer to the Modem instruction manual for the correct strings for   
  876.          your modem.   
  877.                                   -Page 18-    
  878.    TROUBLE SHOOTING Continued...   
  879.    
  880.       5. Modem is incorrectly configured.  Refer to modem manual and set   
  881.          modem dip switches or NVRam for the following:   
  882.          a) Modem must track the actual state of DCD (Carrier) and not be   
  883.             forced.   
  884.          b) Modem should track DTR and not be forced.   
  885.          c) Modem MUST send back verbal result codes such as "OK" or   
  886.             "CONNECT", etc.   
  887.    
  888.       6. See the following   
  889.          Symptom:  QCom status line says "Online" even when not.   
  890.          Cause:   
  891.          Modem Carrier Detect line is forced on.  This MUST toggle on or    
  892.          off depending on the actual Carrier state.  This is set with a    
  893.          modem dip switch or a command sent in the initialization string.     
  894.          Refer to the modem manual.  Edit the initialization string if    
  895.          necessary and use Alt-M to manually send the string to the modem.    
  896.  
  897.          Or toggle the Carrier detect dip-switch if present.   
  898.          Many modem factories typically set this to default to always on.   
  899.          One result of this is QCom will prompt you whether you want to   
  900.          initialize the modem at start-up which is an unnecessary annoyance   
  901.          (the prompt is necessary in the instance where QCom is used as a   
  902.          dumb terminal attached directly to another machine).   
  903.    
  904.    
  905.          Symptom: Pressing Alt-M to re-initialize the modem gets back    
  906.          "ERROR" from the modem.   
  907.          Cause:   
  908.          The modem initialization string (line six in the QCom.CFG file)   
  909.          contains command(s) that the modem does not understand.  Or, the   
  910.          command string is too lengthy.  Refer to the modem manual and    
  911.          remove any command not found in the manual.  Long initialization    
  912.          strings can be broken up into two sections with "^M~~~AT" inserted   
  913.          about halfway.   
  914.    
  915.          Symptom: QCom reports "Unable to find DSZ.COM or DSZ.EXE"   
  916.          Cause:   
  917.          DSZ.COM or DSZ.EXE are not found in the default directory (the    
  918.          same directory as QCom) or in the search path.  Put DSZ into    
  919.          correct directory.   
  920.           
  921.          Symptom:Always get a fast busy signal after dialing. 
  922.          Cause:  
  923.          a) Call waiting string in Options is enabled when the feature 
  924.          is not present on the phone line.  Disable the string by erasing 
  925.          it or prefix it with a semicolon. 
  926.          b) A pause character may need to be added after the string. Most   
  927.          modems recognize a comma as a half second pause. eg:"*70,," 
  928.    
  929.                                       -Page 19-    
  930.    
  931.     ONLINE SUPPORT BBS:   
  932.    
  933.          To obtain further help, or for the latest update of Qcom, you   
  934.          can call the support BBS:   
  935.    
  936.          ************************************************   
  937.          *   Programmer's Oasis, Ph.  1-204-478-3562.   *   
  938.          ************************************************   
  939.    
  940.          
  941.          When calling in, login as a new user with your full name and   
  942.          password of your choice. After answering a few questions you   
  943.          will be given the opportunity to go into the QCom area.   
  944.          Once there you will have 30 minutes to send or receive messages   
  945.          and download files.  Direct all QCom related messages to the 
  946.         author, Richard Turenne.   
  947.    
  948.    
  949.    
  950.       DISCLAIMER:   
  951.    
  952.       This software is provided "as is" without warranty either express or   
  953.       implied.  The user assumes all responsibility in determining its'   
  954.       usefulness and or fitness for any purpose, and assumes all risks and   
  955.       liabilities including damages for loss of business profits, business   
  956.       interruption, or loss of business information arising from the   
  957.       operation of this software.   
  958.    
  959.    
  960.    
  961.    
  962.    
  963.    
  964.    
  965.    
  966.    
  967.    
  968.    
  969.    
  970.     
  971.   
  972.  
  973.   
  974.  
  975.   
  976.  
  977.   
  978.  
  979.                                   -Page 20-   
  980.  
  981.                                         
  982.  
  983.                                         
  984.  
  985.              **************************************************  
  986.  
  987.                               QCOM REGISTRATION  
  988.  
  989.                                         
  990.  
  991.                  If you use QCom,  please register it.  This  
  992.                 software is the result of a great deal of time  
  993.             and effort.  Please support its' continued development  
  994.                           and the Shareware concept.  
  995.  
  996.                                 WHY REGISTER ?           
  997.        Those who register will be shown how to set up and use the 
  998.        user defineable ALT-Key functions.  Users can pre-define other  
  999.       external protocols, or DOS commands, and access them with a single  
  1000.      keystroke. These instructions are essential to make the most of QCom. 
  1001.      Additionally, registrations are the ONLY motivation to continued
  1002.      development of QCom. The time spent on QCom development is directly
  1003.      proportional to the number of registrations. Your support matters.
  1004.                                          
  1005.  
  1006.               The one-time registration fee is a modest $20.00.  
  1007.               To receive a copy of the absolute latest version on  
  1008.                  disk, send an additional $5.00 to cover cost  
  1009.                  of disk, packaging and mailing.  Specify disk  
  1010.                    size desired and your current version.  
  1011.  
  1012.            A quick mailer is provided in the file called Register.  
  1013.                   
  1014.                         Send a check or money order to:  
  1015.                                      
  1016.                                 RTFM  Software  
  1017.                                 108 Egesz St.  
  1018.                                 Winnipeg, Mb. Canada  
  1019.                                 R2R 2E1  
  1020.                                     
  1021.              Your comments, questions, suggestions and bug reports  
  1022.                 are always welcome whether or not you register.  
  1023.         Drop me a note, leave a message on CompuServe I.D. 72361,3117.  
  1024.       Or, leave a message on Programmer's Oasis BBS, Ph.  1-204-478-3562.  
  1025.  
  1026.              **************************************************  
  1027.  
  1028.                                         
  1029.                                     
  1030.                                       
  1031.                                        
  1032.                         
  1033.                            
  1034.                      
  1035.                                   -Page 21- 
  1036.              
  1037.